package com.study.map.service;

import com.study.map.dto.DistrictRequest;
import com.study.map.dto.DistrictResponse;
import com.study.map.exception.MapServiceException;

/**
 * 行政区划查询服务接口
 *
 * @author study
 * @date 2025-08-31
 */
public interface IDistrictService {

    /**
     * 行政区划查询：根据关键字查询行政区划信息
     *
     * @param request 行政区划查询请求参数
     * @return 行政区划查询结果
     * @throws MapServiceException 地图服务异常
     */
    DistrictResponse district(DistrictRequest request) throws MapServiceException;

    /**
     * 行政区划查询：根据关键字查询行政区划信息
     *
     * @param keywords 查询关键字
     * @return 行政区划查询结果
     * @throws MapServiceException 地图服务异常
     */
    DistrictResponse district(String keywords) throws MapServiceException;
}